NativeScript 材料文本字段

NativeScript 的材料设计 文本字段 组件。

内容

1. 安装
2. 变更日志
3. 常见问题解答
4. 用法
   • 纯 NativeScript
   • Angular
   • Vue
5. API

安装

适用于 NativeScript 7.0+

• tns plugin add @nativescript-community/ui-material-textfield

适用于 NativeScript 6.x

• tns plugin add nativescript-material-textfield

如果使用 tns-core-modules

• tns plugin add [email protected]

在添加插件后，请务必运行新的构建以避免任何问题。

变更日志

常见问题解答

用法

纯 NativeScript

重要提示：请确保在页面元素上包含 xmlns:mdt="@nativescript-community/ui-material-textfield"。

XML

<Page xmlns:mdt="@nativescript-community/ui-material-textfield">
    <StackLayout horizontalAlignment="center">
        <mdt:TextField text="raised textfield"/>
        <mdt:TextField variant="flat" text="flat textfield"/>
        <mdt:TextField variant="text" text="text textfield"/>
        <mdt:TextField elevation="5" rippleColor="red" text="raised custom textfield"/>
   </StackLayout>
</Page>

CSS

mdtextfield {
    ripple-color: blue;
    elevation: 4;
    stroke-color: blue;             /* the border color when active */
    stroke-inactive-color: green;   /* the border color when inactive */
    floating-color: blue;           /* the floating placeholder color when active */
    floating-inactive-color: green; /* the floating placeholder color when inactive */
}

NativeScript + Angular

import { NativeScriptMaterialTextFieldModule } from "@nativescript-community/ui-material-textfield/angular";

@NgModule({
    imports: [
        NativeScriptMaterialTextFieldModule,
        ...
    ],
    ...
})

<MDTextField  helper="example helper" placeholderColor="green" keyboardType="datetime"
        hint="i am an hint" returnKeyType="next" (focus)="onFocus($event)" (blur)="onBlur($event)"
        (textChange)="onTextChange($event)"></MDTextField>

NativeScript + Vue

import TextFieldPlugin from '@nativescript-community/ui-material-textfield/vue';

Vue.use(TextFieldPlugin);

<MDTextField helper="example helper" placeholderColor="green" keyboardType="datetime"
        hint="i am an hint" returnKeyType="next" @focus="onFocus" @blur="onBlur"
        @textChange="onTextChange"/>

此外，您还可以使用 v-model 指令将文本绑定到某些实例数据。

<MDTextField v-model="value" />

API

属性

继承自 NativeScript TextField，因此它已经具有所有相同的属性。

• variant 可选

一个用于设置文本字段变体的属性。可以是 outline、underline 或 filled。无值表示 underline 文本字段。

• errorColor 可选

一个用于设置文本字段错误颜色的属性。

• helper 可选

一个用于设置文本字段辅助文本的属性。

• floating 可选

一个用于设置文本字段浮动状态的布尔属性。