Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[zh-cn]: create docs for HTMLLabelElement #22816

Merged
merged 3 commits into from
Aug 2, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
32 changes: 32 additions & 0 deletions files/zh-cn/web/api/htmllabelelement/control/index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,32 @@
---
title: HTMLLabelElement:control 属性
slug: Web/API/HTMLLabelElement/control
l10n:
sourceCommit: d16706e4e930c57161d473287374a9286c663147
---

{{APIRef("HTML DOM")}}

**`HTMLLabelElement.control`** 只读属性返回与 {{HTMLElement("label")}} 元素相关联的控件(以 {{domxref("HTMLElement")}} 类型或其派生类的对象的形式)的引用,如果标签未与控件关联,则为 `null`。

## 值

{{domxref("HTMLElement")}} 派生对象,表示与 {{HTMLElement("label")}} 关联的控件,如果标签是单独的,则为 `null`。

> [!NOTE]
> 如果这个属性有值且 {{domxref("HTMLLabelElement.htmlFor")}} 有值,{{domxref("HTMLLabelElement.htmlFor")}} 属性必须引用相同的控件。

## 规范

{{Specifications}}

## 浏览器兼容性

{{Compat}}

## 参见

- {{domxref("HTMLLabelElement")}}
- {{domxref("HTMLElement")}}
- {{HTMLElement("label")}}
- [HTML 表单指南](/zh-CN/docs/Learn/Forms)
31 changes: 31 additions & 0 deletions files/zh-cn/web/api/htmllabelelement/form/index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,31 @@
---
title: HTMLLabelElement:form 属性
slug: Web/API/HTMLLabelElement/form
l10n:
sourceCommit: 595cba0e07c70eda7f08a12890e00ea0281933d3
---

{{APIRef("HTML DOM")}}

**`HTMLLabelElement.form`** 只读属性返回表示与标签关联的控件所属表单的 {{domxref("HTMLFormElement")}} 对象,如果没有关联的控件,或者该控件未与表单关联,则为 `null`。

这个属性是 `HTMLLabelElement.control.form` 的快捷方式。

## 值

{{domxref("HTMLFormElement")}},表示与标签的 {{domxref("HTMLLabelElement.control", "control")}} 像关联的表单。如果 {{domxref("HTMLLabelElement.control", "control")}} 是 `null`(意味标签与控件无关),或者如果控件不是不属于某个表单,属性返回 `null`。

## 规范

{{Specifications}}

## 浏览器兼容性

{{Compat}}

## 参见

- {{domxref("HTMLLabelElement")}}
- {{domxref("HTMLElement")}}
- {{HTMLElement("label")}}
- [HTML 表单指南](/zh-CN/docs/Learn/Forms)
33 changes: 33 additions & 0 deletions files/zh-cn/web/api/htmllabelelement/htmlfor/index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,33 @@
---
title: HTMLLabelElement:htmlFor 属性
slug: Web/API/HTMLLabelElement/htmlFor
l10n:
sourceCommit: d16706e4e930c57161d473287374a9286c663147
---

{{APIRef("HTML DOM")}}

**`HTMLLabelElement.htmlFor`** 属性反映 [`for`](/zh-CN/docs/Web/HTML/Element/label#for) 内容属性的值。意味着此脚本可访问属性用于设置和读取内容属性 `for`(该属性是标签关联的控件元素的 ID)的值。

## 值

包含与控件相关元素 ID 的字符串。

> [!NOTE]
> 如果属性有值,{{domxref("HTMLLabelElement.control")}} 属性必须引用相同的控件。

## 规范

{{Specifications}}

## 浏览器兼容性

{{Compat}}

## 参见

- {{domxref("HTMLLabelElement")}}
- {{domxref("HTMLLabelElement.control")}}
- {{domxref("HTMLElement")}}
- {{HTMLElement("label")}}
- [HTML 指南](/zh-CN/docs/Learn/Forms)
44 changes: 44 additions & 0 deletions files/zh-cn/web/api/htmllabelelement/index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,44 @@
---
title: HTMLLabelElement
slug: Web/API/HTMLLabelElement
l10n:
sourceCommit: d16706e4e930c57161d473287374a9286c663147
---

{{ APIRef("HTML DOM") }}

**`HTMLLabelElement`** 接口允许访问特定于 {{HTMLElement("label")}} 元素的属性,它从基础接口 {{domxref("HTMLElement")}} 继承方法和属性。

{{InheritanceDiagram}}

## 实例属性

_从其父接口 {{domxref("HTMLElement")}} 继承属性。_

- {{domxref("HTMLLabelElement.control")}} {{ReadOnlyInline}}
- : {{domxref("HTMLElement")}},表示与标签关联的控件。
- {{domxref("HTMLLabelElement.form")}} {{ReadOnlyInline}}
- : {{domxref("HTMLFormElement")}} 对象,表示与标记的控件相关联的表单,如果没有关联的控件,或者该控件未与表单关联,则为 `null`。换句话说,这只是 `HTMLLabelElement.control.form` 的快捷方式。
- {{domxref("HTMLLabelElement.htmlFor")}}
- : 包含标记的控件的 ID 的字符串。反映 [`for`](/zh-CN/docs/Web/HTML/Element/label#for) 属性。

> [!NOTE]
> 要以编程方式设置 `for` 属性,请使用 [`htmlFor`](/zh-CN/docs/Web/API/HTMLLabelElement/htmlFor)。

## 实例方法

_没有特定的方法,从其父接口 {{domxref("HTMLElement")}} 继承方法。_

## 规范

{{Specifications}}

## 浏览器兼容性

{{Compat}}

## 参见

- 实现此接口的 HTML 元素:{{HTMLElement("label")}}
- {{HTMLElement("form")}}
- {{domxref("HTMLFormElement")}}