@api-components/api-form-mixin

中文文档
3.1.4发布于 2021/07/29Apache-2.0ESM + CJS近 30 天下载 3125

A mixin that contains common properties, methods and styles for components that implements AMF based forms

原始使用文档
文档目录8 节
  1. <api-form-mixin>
  2. Deprecation notice
  3. Usage
  4. Installation
  5. In a LitElement
  6. Development
  7. Running the demo locally
  8. Running the tests

Published on NPM

Build Status

<api-form-mixin>

A mixin to be used with elements that processes AMF data via form data model and displays forms from the model.

It contains common methods used in forms.

Deprecation notice

This element is moved to api-forms repository and @api-components/api-forms package. This element will be deprecated and archived once the migration finish.

Usage

Installation

npm install --save @api-components/api-form-mixin

In a LitElement

import { LitElement, html, css } from 'lit-element';
import { ApiFormMixin } from '@api-components/api-form-mixin/api-form-mixin.js';
import styles from '@api-components/api-form-mixin/api-form-styles.js';
import '@polymer/iron-form/iron-form.js';

class SampleElement extends LitElement {
  static get styles() {
    return [
      styles,
      css`:host {
        display: block;
      }`
    ];
  }

  render() {
    const { model: items, allowHideOptional, optionalOpened, allowDisableParams } = this;
    return html`
    <h1>Form</h1>
    <iron-form>
      <form enctype="application/json">
      ${items ? items.map((item, index) => html`<div class="form-item">
        <div class="${this.computeFormRowClass(item, allowHideOptional, optionalOpened, allowDisableParams)}">
          <input
            data-index="${index}"
            type="text"
            name="${item.name}"
            ?required="${item.required}"
            .value="${item.value}"
            @change="${this._modelValueChanged}">
        </div>
      </div>`) : undefined}
      </form>
    </iron-form>`;
  }

  _modelValueChanged(e) {
    const index = Number(e.target.dataset.index);
    if (index !== index) {
      return;
    }
    this.model[index].value = e.target.value;
    this._requestRender();
  }
}
customElements.define('sample-element', SampleElement);

Development

git clone https://github.com/advanced-rest-client/api-form-mixin
cd api-form-mixin
npm install

Running the demo locally

npm start

Running the tests

npm test

版本与发布记录

@api-components/api-form-mixin 共发布 14 个版本,首次发布于 2018/05/19;过去 12 个月发布了 0 个版本。

版本发布日期距今
3.1.4latest2021/07/295 年前
3.1.32020/05/156 年前
3.1.22020/05/156 年前
3.1.12020/05/156 年前
3.1.02020/04/266 年前
3.0.42019/12/106 年前

其他发布通道:next → 3.0.0-preview.3。

关于 @api-components/api-form-mixin 的常见问题

@api-components/api-form-mixin 是什么?

A mixin that contains common properties, methods and styles for components that implements AMF based forms

如何安装 @api-components/api-form-mixin?

在项目目录运行 npm install @api-components/api-form-mixin,或使用 pnpm add / yarn add / bun add。

@api-components/api-form-mixin 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/api-components__api-form-mixin 是否存在。

@api-components/api-form-mixin 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@api-components/api-form-mixin 可以商用吗?

@api-components/api-form-mixin 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@api-components/api-form-mixin 的下载量有多少?

根据 npm 官方下载统计,@api-components/api-form-mixin 在 2026/10/06 – 2026/11/04 这 30 天内被下载 3,125 次,日均约 104 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@api-components/api-form-mixin 还在维护吗?

最新版本 3.1.4 发布于 2021/07/29(5 年前);至今共发布 14 个版本,其中过去 12 个月发布了 0 个;首次发布于 2018/05/19。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。