code-crispies/lessons/21-html-forms-basic.json

{
	"$schema": "../schemas/code-crispies-module-schema.json",
	"id": "html-forms-basic",
	"title": "HTML Forms: Basic Inputs",
	"description": "Learn to create forms with various input types",
	"mode": "html",
	"difficulty": "beginner",
	"lessons": [
		{
			"id": "form-structure",
			"title": "Form Structure",
			"description": "Every form needs a <kbd>&lt;form&gt;</kbd> wrapper. Inside, use <kbd>&lt;label&gt;</kbd> to describe inputs and <kbd>&lt;input&gt;</kbd> for user data entry.<br><br>The <kbd>for</kbd> attribute on labels should match the <kbd>id</kbd> on inputs for accessibility.",
			"task": "Create a form with a text input for 'Name'. Include a label connected to the input using for/id attributes.",
			"previewHTML": "",
			"previewBaseCSS": "body { font-family: system-ui; padding: 20px; } form { max-width: 300px; } label { display: block; margin-bottom: 5px; font-weight: 500; } input { width: 100%; padding: 8px; border: 1px solid #ccc; border-radius: 4px; box-sizing: border-box; }",
			"sandboxCSS": "",
			"initialCode": "<!-- Create your form here -->",
			"solutionCode": "<form>\n  <label for=\"name\">Name:</label>\n  <input type=\"text\" id=\"name\" name=\"name\">\n</form>",
			"previewContainer": "preview-area",
			"validations": [
				{
					"type": "element_exists",
					"value": "form",
					"message": "Wrap everything in a <form> element"
				},
				{
					"type": "element_exists",
					"value": "label",
					"message": "Add a <label> for your input"
				},
				{
					"type": "element_exists",
					"value": "input",
					"message": "Add an <input> element"
				},
				{
					"type": "attribute_value",
					"value": { "selector": "label", "attr": "for", "value": null },
					"message": "Add a 'for' attribute to your label"
				},
				{
					"type": "attribute_value",
					"value": { "selector": "input", "attr": "id", "value": null },
					"message": "Add an 'id' attribute to your input"
				}
			]
		},
		{
			"id": "input-types",
			"title": "Input Types",
			"description": "Different input types provide appropriate keyboards and validation:<br><br><kbd>type=\"text\"</kbd> - General text<br><kbd>type=\"email\"</kbd> - Email with @ validation<br><kbd>type=\"password\"</kbd> - Hidden characters<br><kbd>type=\"number\"</kbd> - Numeric keyboard<br><kbd>type=\"tel\"</kbd> - Phone keyboard",
			"task": "Create a login form with an email input and a password input, each with proper labels.",
			"previewHTML": "",
			"previewBaseCSS": "body { font-family: system-ui; padding: 20px; } form { max-width: 300px; } .form-group { margin-bottom: 15px; } label { display: block; margin-bottom: 5px; } input { width: 100%; padding: 8px; border: 1px solid #ccc; border-radius: 4px; box-sizing: border-box; }",
			"sandboxCSS": "",
			"initialCode": "<form>\n  <!-- Add email and password inputs -->\n</form>",
			"solutionCode": "<form>\n  <div class=\"form-group\">\n    <label for=\"email\">Email:</label>\n    <input type=\"email\" id=\"email\" name=\"email\">\n  </div>\n  <div class=\"form-group\">\n    <label for=\"password\">Password:</label>\n    <input type=\"password\" id=\"password\" name=\"password\">\n  </div>\n</form>",
			"previewContainer": "preview-area",
			"validations": [
				{
					"type": "element_exists",
					"value": "input[type='email']",
					"message": "Add an input with type=\"email\""
				},
				{
					"type": "element_exists",
					"value": "input[type='password']",
					"message": "Add an input with type=\"password\""
				},
				{
					"type": "element_count",
					"value": { "selector": "label", "min": 2 },
					"message": "Add labels for both inputs"
				}
			]
		},
		{
			"id": "submit-button",
			"title": "Submit Button",
			"description": "Forms need a way to submit data. Use:<br><br><kbd>&lt;button type=\"submit\"&gt;</kbd> - Preferred, flexible content<br><kbd>&lt;input type=\"submit\"&gt;</kbd> - Simple text-only button<br><br>The button text should be action-oriented (e.g., 'Sign In', 'Register', 'Send').",
			"task": "Add a submit button to the form with the text 'Sign In'.",
			"previewHTML": "",
			"previewBaseCSS": "body { font-family: system-ui; padding: 20px; } form { max-width: 300px; } .form-group { margin-bottom: 15px; } label { display: block; margin-bottom: 5px; } input { width: 100%; padding: 8px; border: 1px solid #ccc; border-radius: 4px; box-sizing: border-box; } button { width: 100%; padding: 10px; background: #1976d2; color: white; border: none; border-radius: 4px; cursor: pointer; font-size: 16px; } button:hover { background: #1565c0; }",
			"sandboxCSS": "",
			"initialCode": "<form>\n  <div class=\"form-group\">\n    <label for=\"email\">Email:</label>\n    <input type=\"email\" id=\"email\">\n  </div>\n  <div class=\"form-group\">\n    <label for=\"password\">Password:</label>\n    <input type=\"password\" id=\"password\">\n  </div>\n  <!-- Add submit button -->\n</form>",
			"solutionCode": "<form>\n  <div class=\"form-group\">\n    <label for=\"email\">Email:</label>\n    <input type=\"email\" id=\"email\">\n  </div>\n  <div class=\"form-group\">\n    <label for=\"password\">Password:</label>\n    <input type=\"password\" id=\"password\">\n  </div>\n  <button type=\"submit\">Sign In</button>\n</form>",
			"previewContainer": "preview-area",
			"validations": [
				{
					"type": "element_exists",
					"value": "button[type='submit'], input[type='submit']",
					"message": "Add a submit button to your form"
				},
				{
					"type": "element_text",
					"value": { "selector": "button", "text": "Sign In" },
					"message": "The button should say 'Sign In'"
				}
			]
		}
	]
}