属性 API

提示

标准化组件统一了 PC 端、H5 端和小程序端实现，同时对外开放支持一系列标准 API，支持样式 API 和自定义 CSS 变量 等。标准化组件都在组件列表中添加 的标注。

标准化组件暴露了属性 API（Widget API），可以获取组件内部的状态和属性值，可以通过 $w.componentId.propertyName 来访问组件内部的值，如 $w.input1.value 可以获取页面中 id 为 input1 的单行输入组件的用户输入值。

组件属性 API 列表

如需了解组件暴露了哪些属性 API，请参考组件文档中 属性 API 章节。

属性 API 和属性的区别

属性是组件接收的外部传入的值，可以在组件的设置面板中进行配置。属性可以用于控制组件的行为和外观，例如输入框的值、按钮的文本等。

属性 API 则是一种编程接口，可以通过代码来获取的属性值和状态值。在代码中，可以使用 $w 对象来访问页面上的组件，并使用 $w.componentId.propertyName 来获取属性 API 值。例如，可以使用 $w.input1.value 来获取输入框的值。

需要注意的是，属性 API 是只读的，不可以进行直接修改，需要时可以调用组件暴露的方法进行修改，或者修改组件属性上绑定的变量。

属性和属性 API 的主要区别在于使用方式和作用范围。属性是在组件的设置面板中进行配置，并且只能在组件内部使用。而属性 API 则是在代码中使用，并且可以在组件外部和内部使用。属性 API 可以让开发者更加灵活地控制组件的行为和外观，从而实现更加复杂的功能。